home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / rlog_128.zip / REMOTLOG.DOC < prev    next >
Text File  |  1990-09-01  |  18KB  |  491 lines
  1.                                     
  2.  
  3.  
  4.  
  5.                          R E M O T E   A C C E S S
  6.  
  7.  
  8.                   L O G  R E P O R T I N G  P R O G R A M
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                 REMOTLOG
  15.  
  16.    //////    /////  /      /  ///////  ///////   /        ///////  ///////
  17.    /     /   /      / /   //  /     /     /      /        /     /  /
  18.    //////    ///    /   /  /  /     /     /      /        /     /  /   ///
  19.    /     /   /      /      /  /     /     /      /        /     /  /     /
  20.    /      /  /////  /      /  ///////     /      ///////  ///////  ///////
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. The Program  - Remotlog
  68.  
  69.  
  70.         I developed Remotlog because when the announcement of RA was made and I
  71.         endeavored to switch from QuickBBS.  There was something missing.  I
  72.         could no longer use all my QBBS utilities.  After exhaustive efforts of
  73.         trying to get the implementation of my old program by its author, I
  74.         decided that it was time to do some coding.
  75.  
  76.         Here we have the finished product.  A full fledged RA log reporting
  77.         program.  This program is in no way crippled.  And never will be.
  78.  
  79.  
  80.  
  81.         RA is the registered product of Continental Software.
  82.         QuickBBS is the registered product of The QuickBBS Support Group or whatever it is now adays.
  83.  
  84.  
  85.         At present this program will function with RA version 0.0X.
  86.  
  87.         Do not attempt to use this program with any other software except RA
  88.         because it uses the file MESSAGES.RA.  If it cannot find this file the
  89.         program will abort in error.
  90.  
  91.         The screens provided by this program are as the author thought you
  92.         the sysops would like to see.  If you feel the information is too much
  93.         or that there is not enough, or would even like to see some of the
  94.         information moved from one location to another part of the page or a
  95.         totaly different screen.  Please do not hesitate to let the author
  96.         know.
  97.  
  98.  
  99.  
  100.  
  101. Configuration of Remotlog
  102.  
  103.    This is exactly as it appears in the Configuration file.  If you haven't
  104.    unzipped it.  It would behove you to do so.  And use it.  RTFM is now in
  105.    effect.
  106.  
  107. ;-------------------------------------------------------------------------
  108. ;                       Remotlog Configuration file
  109. ;                        By Orland Carter 1:135/72
  110. ;-------------------------------------------------------------------------
  111. ;
  112. ;-------------------------------------------------------------------------
  113. ;               R E G I S T R A T I O N   I N F O R M A T I O N
  114. ;-------------------------------------------------------------------------
  115. ;         {______________________________}
  116. BoardName  Opa-Locka Tower
  117. ;         {____________________}
  118. SysopName  Orland Carter
  119. RegistKey  00000000000000000000
  120. ;
  121. ;-------------------------------------------------------------------------
  122. ; This is a required entry.  It tells the program the [path + filename] of
  123. ; the Log file to be processed.
  124. ; DEFAULT : SYSTEM.LOG
  125. ;-------------------------------------------------------------------------
  126. ;
  127. LogFile SYSTEM.LOG
  128. ;
  129. ;-------------------------------------------------------------------------
  130. ; This option is required if you want REMOTLOG to process the file Xfers
  131. ; against the files counter for a good downloaded count.  The DEFAULT is
  132. ; NOFDLOGFILE  the other option is FDLOGFILE \.......\  where \..\ is the
  133. ; [Path + Filename] of the FD log file.
  134. ;-------------------------------------------------------------------------
  135. ;
  136. FDLogFile C:\Fd\Fd.Log
  137. ;
  138. ;-------------------------------------------------------------------------
  139. ; This option is required.  It tells the program what the Dos Shell entry
  140. ; of your External chat program is.  This must be the same case as the
  141. ; BBS writes it to the log file.  Required whether you have one or not.
  142. ; DEFAULT : FX-CHAT.EXE
  143. ;-------------------------------------------------------------------------
  144. ;
  145. ExternalChat FastChat.EXE
  146. ;
  147. ;-------------------------------------------------------------------------
  148. ; This option is required.  It tells the program what [path + filename]
  149. ; the output of the program should be placed in. *.asc/*.ans versions.
  150. ; DEFAULT : REMOTLOG
  151. ;-------------------------------------------------------------------------
  152. ;
  153. Outputfile c:\RA\Txt\Remotlog
  154. ;
  155. ;-------------------------------------------------------------------------
  156. ; This option is required.  It tells the program which color to place the
  157. ; background of the ansi screen in.
  158. ; DEFAULT : 40
  159. ;-------------------------------------------------------------------------
  160. ;
  161. Back 40
  162. ;
  163. ;-------------------------------------------------------------------------
  164. ; This option is required.  It tells the program what color the numbers
  165. ; displayed are.
  166. ; DEFAULT : 1;33
  167. ;-------------------------------------------------------------------------
  168. ;
  169. Numbers 1;33
  170. ;
  171. ;-------------------------------------------------------------------------
  172. ; This option is required.  It tells the program what color to use when
  173. ; highlighting the Beginning and Ending dates of the Log period.
  174. ; DEFAULT : 1;46;37
  175. ;-------------------------------------------------------------------------
  176. ;
  177. HighLight 1;46;37
  178. ;
  179. ;-------------------------------------------------------------------------
  180. ; This option is required.  It tells the program which color to use to
  181. ; restore the screen to "normal".
  182. ; DEFAULT : 0
  183. ;-------------------------------------------------------------------------
  184. ;
  185. Normal 0
  186. ;
  187. ;-------------------------------------------------------------------------
  188. ; This option is required.  It tells the program which color to use for
  189. ; Outlining the Box and Dividing lines of the output file.
  190. ; DEFAULT 1;34
  191. ;-------------------------------------------------------------------------
  192. ;
  193. Outline 1;34
  194. ;
  195. ;-------------------------------------------------------------------------
  196. ; This option is required.  It tells the program which color to use for
  197. ; all the text that is printed.
  198. ; DEFAULT 0;32
  199. ;-------------------------------------------------------------------------
  200. ;
  201. Text 0;32
  202. ;
  203. ;-------------------------------------------------------------------------
  204. ; This option is required.  It tells the program whether or not you wish
  205. ; the optional page of Multiline usage to be displayed.  The statistics
  206. ; will still be stored if the option is not selected.
  207. ; DEFAULT : NOMULTILINE
  208. ;-------------------------------------------------------------------------
  209. ;
  210. NoMultiLine
  211. ;
  212. ;-------------------------------------------------------------------------
  213. ; This option is required.  It telss the program what type of log file
  214. ; You are using.  Wheter FD [Front Door type] or OPUS.
  215. ; DEFAULT FD
  216. ;-------------------------------------------------------------------------
  217. ;
  218. FD
  219. ;
  220. ;-------------------------------------------------------------------------
  221. ; This option is not required and at the descretion of the sysop.  Using
  222. ; This will cause another page to be displayed in addition to the current
  223. ; 2 or 3 pages that are already displayed.  This option is where the sysop
  224. ; Can have remotlog search the logfile for something specific and keep
  225. ; track of its occurrences.
  226. ; I.e. *01My_Name Carter      - This will cause remotlog to search the log
  227. ; file for all occurences of "Carter" it will accumulate and store the
  228. ; amount of time it finds it in variable 01.  When it displays it it will
  229. ; display "My_Name >>> ####" where # is amount of times the item was found
  230. ; Possible Variables are 00-10.  The 0 is significant.  The "*" is required
  231. ; There can be no spaces except to separate the Display item from the
  232. ; Search item.
  233. ; Format "*<Variable 00-10><Entry to Make in *.Ans/*.Asc file> <Search For>"
  234. ;         *00My_Name Carter
  235. ;-------------------------------------------------------------------------
  236. ;
  237. ;*00Graffitti_Wall  Grafn3.EXE
  238. ;*01JetFighter_Game Combat 1
  239. ;
  240. ;-------------------------------------------------------------------------
  241. ; These options are not required.  But they do provide you with a great
  242. ; amount of security.  For areas you do not want all your users to see.
  243. ; IE. Adult areas or Sysop areas.
  244. ; DEFAULT - NONE.  200 MAXIMUM ENTRIES.
  245. ;-------------------------------------------------------------------------
  246. ;
  247. NoShow  8
  248. NoShow 10
  249. NoShow 12
  250. ;
  251. ;-------------------------------------------------------------------------
  252. ; This option is not required.  It is used to Change the default Sealink
  253. ; protocol displayed in the 1st output page to a protocol of your choosing.
  254. ; REPLACESEA - Is the Search String for the new protocol.
  255. ; REPLACEDSP - Is the Actual Item to be displayed in the Output page.
  256. ;-------------------------------------------------------------------------
  257. ;
  258. ;ReplaceSea SEALink
  259. ;ReplaceDsp SEALink
  260. ;
  261. ;-------------------------------------------------------------------------
  262. ; This option is also not required.  It determines whether or not the local
  263. ; logons will be shown on the report output.  The DEFAULT for this option
  264. ; is show local logons.  Leave this option out for the default to take
  265. ; effect.
  266. ;-------------------------------------------------------------------------
  267. ;
  268. ;NoLocal
  269. ;
  270. ;-------------------------------------------------------------------------
  271. ; This option is also not required.  It activates or deactivates the
  272. ; Files.BBS downloaded files counter.  The count will be stored and added
  273. ; to the Files.BBS in the directory the file was taken from.  DEFAULT for
  274. ; This option is FILECOUNTER,     To deactivate use NOFILECOUNT
  275. ;-------------------------------------------------------------------------
  276. ;
  277. FILECOUNTER
  278. ;
  279. ;-------------------------------------------------------------------------
  280. ; This option is also not required.  It activates a chat record.  This will
  281. ; log all chats found in the log file to a file called REMOTLOG.CHT in the
  282. ; current directory.  The DEFAULT is CHATRECORD, all chats will be logged.
  283. ; The other option to disable the chat is NOCHATRECORD
  284. ; A file is created named REMOTLOG.CHT
  285. ;-------------------------------------------------------------------------
  286. ;
  287. CHATRECORD
  288. ;
  289. ;-------------------------------------------------------------------------
  290. ; This option is also not required.  It activates or Deactivates the log
  291. ; deleting option.  The DEFAULT is the log will be deleted every 10 days.
  292. ; The two options are DELTELOG ## (Where ## is days log should be kept.)
  293. ; and NODELETELOG.
  294. ;-------------------------------------------------------------------------
  295. ;
  296. DELETELOG 7
  297. ;
  298. ;-------------------------------------------------------------------------
  299. ; This option is also not required.  It activates or Deactivates the log
  300. ; deleting option.  The DEFAULT is the fd log will be deleted with the RA log.
  301. ; The two options are DELTEFDLOG and NODELETEFDLOG.
  302. ;-------------------------------------------------------------------------
  303. ;
  304. DELETEFDLOG
  305. ;
  306. ;-------------------------------------------------------------------------
  307. ; This option is also not required.  It will determine whether or not the
  308. ; Log file actually gets deleted or zipped up and given an individual date
  309. ; for storage.  The zip method used is PKZIP.  any version.  The file will
  310. ; be moved while zipped.  The zipped name will be in the format RLOGMMDD.0YY
  311. ; This option will not function if the Delete log option is disabled.
  312. ; Pkzip must be in the current directory or properly pathed.
  313. ; DEFAULT - NOZIPFILE           other otion is ZIPFILE
  314. ;-------------------------------------------------------------------------
  315. ;
  316. NOZIPFILE
  317. ;
  318. ;-------------------------------------------------------------------------
  319. ; This option is again not required.  It determines whether or not REMOTLOG
  320. ; Will consider a filename without the drive specifier in it as valid within
  321. ; the filecounter section.  EX...   NETFILE\00000046.MO1  and
  322. ; C:\FD\NETFILE\00000046.MO1 both show the same file being downloaded however
  323. ; only one gives REMOTLOG access to the file the second filename.  The first
  324. ; filename can cause problems however because remotlog will have no idea which
  325. ; directory the file belongs in.
  326. ; OPTIONS    NOCOLON          COLON
  327. ; NoColon says that you don't care if it does or doesn't have a drive specifier
  328. ; Colon tells remotlog to ignore the file if it doesn't say what drive.
  329. ; DEFAULT  NOCOLON
  330. ;-------------------------------------------------------------------------
  331. ;
  332. NoColon
  333. ;
  334. ;-------------------------------------------------------------------------
  335. ;          E N D    O F    R E M O T L O G . C F G   F I L E
  336. ;-------------------------------------------------------------------------
  337.  
  338.  
  339. Here is a quick Batch file example to demonstrate the use of the Chat logging
  340. feature.
  341.  
  342. Batch File .........
  343.      REMOTLOG
  344.      Mbutil Post Remotlog.Cht #28 -To "Orland Carter" -From "Remotlog" -Subject "Chat Requests"
  345.      Del Remotlog.cht
  346.      MSTRDIR
  347.      ren mstrdir.cfg *.tmp     ; If you have MSTRDIR this can be used to handle
  348.      ren mstrdir.g   *.cfg     ; different security level type files listings.
  349.      MSTRDIR
  350.      ren mstrdir.cfg *.g
  351.      ren mstrdir.tmp *.cfg
  352. End Of Batch File....................
  353.  
  354.  
  355.  
  356.  
  357.  
  358. Supplied ANSI Code sequences
  359.  
  360. Number  Represents
  361. ------  ----------
  362. 0       All attributes off  (Normal Display)
  363.  
  364. 1       High Intensity (Bold)
  365.  
  366. 5       Sets Blink on
  367.  
  368. 7       Reverse Video on
  369.  
  370. 8       Concealed on (makes display invisible)
  371.  
  372. 30      Foreground      Black
  373.  
  374. 31                      Red
  375.  
  376. 32                      Green
  377.  
  378. 33                      Yellow
  379.  
  380. 34                      Blue on Color Monitor
  381.                         Underline on MonoChrome
  382.  
  383. 35                      Magenta
  384.  
  385. 36                      Cyan
  386.  
  387. 37                      White
  388.  
  389. 40      BackGround      Black
  390.  
  391. 41                      Red
  392.  
  393. 42                      Green
  394.  
  395. 43                      Yellow
  396.  
  397. 44                      Blue
  398.  
  399. 45                      Magenta
  400.  
  401. 46                      Cyan
  402.  
  403. 47                      White
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410. Hints about operation of this program
  411.  
  412.   There are several different things that you can do to get certain results
  413.   from this program.
  414.  
  415.    For example if you want to change the beging date of the report without
  416.    erasing the remotlog.dat file.  All you have to do is to edit the .DAT file
  417.    find the string that has the date in it and make it a null string.  When the
  418.    program starts up it will notice the date is missing and get the date from
  419.    the current system.log file.
  420.  
  421.    When reading the log file the program will not attempt to reposition pointers
  422.    if the last item in the log is that REMOTLOG has checked the log.  Of course
  423.    the current session will be appended to the end of the logfile.
  424.  
  425.    By deleting the notations that REMOTLOG makes in the log file you can force
  426.    it to re-process the log file.
  427.  
  428.    Any bug reports, comments, or requested addition, deletions etc. may be sent
  429.    to Node 1:135/72.  or the address listed in the registration section.  I can
  430.    also be reached in the RA_SUPPORT and RA_UTIL echos.  Before you send me a
  431.    bug report if you are not registered and if you are.  Insure that you RTFM
  432.    and RTF the configuration file comments before screaming bug report.  If you
  433.    send me netmail bug reports and are not registered do not wait for a netmail
  434.    reply.  It cost me money to send a net message back to you and you couldn't
  435.    find it to register.  All bug reports must contain a copy of Errors.log and
  436.    a summarized copy of your configuration file.  Meaning leave out all the lines
  437.    with a ";" in them.  Explain the bug in full detail.  If not I will simply
  438.    ignore it or send you a message indicating that I will take no action until
  439.    you can meet the bug report requirements.
  440.  
  441.  
  442.  
  443. Credits
  444.  
  445.    The author, Orland K. Carter, would like to thank my beta testers of
  446.    this program that put up with the constant updates to the one program and
  447.    major overhaul of their configuration and data files.
  448.  
  449.    Daniel Johnston, and Robert Taylor, Peter Janssens thank you for your
  450.    patience, and help in beta testing this program.
  451.  
  452.  
  453. Registrations
  454.  
  455.    The cost to register REMOTLOG is whatever you feel the program is worth.
  456.    From $3 and up. Registrations will be sent to.
  457.  ________________________________________________________________________
  458. |Registration of REMOTLOG,                      Form 01, U.Date 31 Aug 90|
  459. |------------------------------------------------------------------------|
  460. |                                                                        |
  461. |SysopName                                                               |
  462. |Name of Sysop __________________________________________________________|
  463. |                                                                        |
  464. |Street Address__________________________________________________________|
  465. |                                                                        |
  466. |City/St/Zip   __________________________________________________________|
  467. |                                                                        |
  468. |BoardName                                                               |
  469. |Name of BBS   __________________________________________________________|
  470. |                                                                        |
  471. |Number of BBS __________________________________________________________|
  472. |                                                                        |
  473. |Node #        __________________________________________________________|
  474. |                                                                        |
  475. |Make all payments address to                                            |
  476. |  Orland K. Carter, REMOTLOG                                            |
  477. |  2850 N.W. 155 Terrace                                                 |
  478. |  Opa-Locka, FL  33054-2223                                             |
  479. |________________________________________________________________________|
  480.  
  481. Thank you for your support.
  482.  
  483.         Orland
  484. Node 1:135/72   Fido Net
  485.      99:9005/18 EGGnet
  486.      55:9/8349  CAPnet
  487.  
  488. Thank you for your support.
  489.  
  490.         Orland
  491.